home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2000 #4 / Amiga Plus CD - 2000 - No. 4.iso / Tools / Text / HTML / CarcHTML / CarcHTML.readme < prev    next >
Text File  |  2000-05-18  |  4KB  |  101 lines
  1. Short:    V1.1 Create HTML page for archived files +src
  2. Uploader: mark@kontumnam.freeserve.co.uk (Mark Weller)
  3. Author:   mark@kontumnam.freeserve.co.uk (Mark Weller)
  4. Type:     comm/www
  5. Replaces: comm/www/CarcHTML.lha
  6. URL:      www.kontumnam.freeserve.co.uk
  7.  
  8. CarcHTML
  9. --------
  10. This program searches a given directory containing archived files
  11.  zip,lha,dms and so on .... and produces an HTML page (index.html)
  12.  in the given directory used for downloading.
  13. The HTML page will display a table of all the files and sizes and the
  14.  readme files and if option chosen different colours for each column
  15.  and background colour for the page.
  16.  also if option chosen you can display Short: description (instead of
  17.  myfile.readme) taken from the files readme file.
  18.  
  19. Changes since ver 1.00:
  20. -----------------------
  21. . now ignores .info files ( I got the Hint ! I spend to much time in the cli.).
  22. . new option to add own Title.
  23.  
  24. Usage:
  25. ------
  26.  
  27. CarcHTML [-vatb] <dirname> [[pagecol] [clmn1col] [clmn2col] [clmn3col]] [title]
  28.  
  29.  [-vatb] Options   -
  30.                    v  : Verbose - List files being processed.
  31.                    a  : Aminet  - Use Short: description.
  32.                    t  : Title   - Title of page/top of archive list.
  33.                           Default is Download.
  34.                    b  : use chosen background colours (default is WHITE).
  35.                         [pagecolour]  - html page background colour.
  36.                         [clmn1col]    - filename column colour.
  37.                         [clmn2col]    - filesize column colour.
  38.                         [clmn3col]    - readmefile/Short: column colour.
  39.                         -*-note-*- you must set all colours if this option chosen.
  40.  
  41.  <directoryname> - directory containing archived files.
  42.  
  43.  -*-Note-*- colours range from  black     white    [R]ed [G]reen [B]lue
  44.                                 000000 -> FFFFFF   00    00      00
  45.   for this version its assumed there is  a readme file for each archive.
  46.         ( CarcHTML.lha  CarcHTML.readme)
  47.         (  myprogs.lha   myprogs.readme)
  48.   also if aminet option chosen - there is a Short: description at top of
  49.    the readme file (like this readme you are reading).
  50.  
  51. Examples:
  52. ---------
  53.   CarcHTML  Work:archive
  54.      This will create HTML page with default colours and no Short: option
  55.       and default title.
  56.  
  57.            mypics.lha  2.5MB   mypics.readme
  58.           myprogs.lha  686KB   myprogs.readme
  59.          mysounds.lha  1.2MB   mysounds.readme
  60.  
  61.   CarcHTML -at  Work:archive  "Downloads this site"
  62.      This will create HTML page with default colours and Short: option if
  63.       found and the given title (put " " around title if more than one word).
  64.  
  65.            mypics.lha  2.5MB   Spice Girls Pictures [Horror]
  66.           myprogs.dms  686KB   myprogs.readme
  67.          mysounds.zip  1.2MB   Selected Loony Tunes [Classical]
  68.  
  69.   CarcHTML -ab Work:archive  FFFFFF 888888 FFFF00 0000FF
  70.      This will create HTML page with chosen colours and  Short: option.
  71.  
  72.            mypics.lha  2.5MB   Spice Girls Pictures [Horror]
  73.           myprogs.dms  686KB   myprogs.readme
  74.          mysounds.zip  1.2MB   Selected Loony Tunes [Classical]
  75.  
  76.   CarcHTML -vab Work:archive  FFFFFF 888888 FFFF00 0000FF
  77.      Same as last example except will list files being processed
  78.       in shell (cli).
  79.  
  80.   This version is fully working and contains some error checking
  81.    but some not finished yet.
  82.    example: the program will index all files in the directory assuming
  83.             they are all archive files - but will ignore files with
  84.             these extensions .readme .html .htm .shtml .info .
  85.    so a file called myprogs.doc will be classed as a archive - it is
  86.     nearly impossible to check each archive file as there are so many
  87.     different types.
  88.  
  89.    I have included the source code with this program - I used Dice to
  90.      compile it, but should compile using any compiler.
  91.  
  92.    If you find this program or source code useful please e-mail me
  93.     if not - sorry for wasting your time!
  94.  
  95.   Thank you to everyone who have responded and find this program useful.
  96.  
  97.   keeping the Amiga alive!
  98.     -*- Mark Weller -*-
  99.  
  100.  
  101.